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Creating Programs for Able Series Computers 


New England Digital’s Scientific XPL Operating System is an easy to 
use Operating System that is used to create real-time programs for an ABLE 
conputer. The system operates in an interactive mode using commands fron 
the terminal to perform a wide variety of editing functions, Features are 
included in the operating system that allow a novice user to easily enter 
and debug short real-time programs, while a computer professional can 
quickly and efficiently develop complete system modules. 


The Operating System includes an Editor, a 3-pass Optimizing Compiler, 
and several utility programs that perform many important functions, Pro- 
grams are entered into the system on a line by line basis using line nun- 
bers. Since the Blitor is an integral part of the Operating System, a 
special edit command is not required and new lines may be entered at any 
time. This feature greatly simplifies the interactive task of writing 
short test programs. 


Commands such es NEW, OLD, SAVE, and REPLACE are used to direct the 
operation of the system. Once a program has been entered into the system 
and saved on diskette, it may easily be compiled and automatically exe- 
cuted by using RUN. Most compilations are performed in 7 to 15 seconds, 
depending on system configuration. Large programs are compiled at a rate 
of over 1000 lines per minute. Since compiled programs are stored in 
memory image format, pre-compiled programs may be executed with essentially 
instantaneous response times. 


Video editing is accomplished by using the CRT command. When the sys- 
tem is in CRT mode, terminal output is presented on a page by page basis. 
Single lines or conplete pages may be presented on the screen by pressing 
a single key on the terminal. The position of the cursor is automatically 
controlled by using conirol-2, to simplify character by character editing. 
Additionally, a control-S may be used at any time to freeze the display when 
using a high speed video terminal. 


Fdit commands are used to process entire blocks of information by 
specifying groups of lines. Functions such as EXTRACT, DELETE, MOVE, and 
APPEND may easily be performed on segments of a file. The CHANGE and LOCATE 
conmands provide string editing functions thet operate on a single line, a 
group of lines, or several grouvs of lines at the same time. The FRINT con- 
mand is available for directing output to a remote hard copy terminal. 


System Peatures 


The Scientific XPL Operating System is the most efficient software 
package available for scientific and industrial control applications. Seci- 
entific XPL is a structured programming language that provides the programmer 


with the programming ease of a modern high level language, yet also provides 
the capability to perform high speed data collection, bit manipulation, logi- 
cal expression processing, and many other real-time functions with an effici- 
ency that on other systems is only available with assembly language programs. 
The Seientific XPL Compiler forms the heart of the Scientific XPL Operating 
System. 


The efficiency of Scientific XPL derives from the three pass architec- 
ture of the compiler. The three pass approach has many advantages when 
compared with the interpretive or single pass approach used on other systems. 
Since all of the symbol table processing is performed during pass one, a 
Sreat deal of memory is made available during pass two for a powerful op- 
timization routine. This routine creates a tree structure for every arith- 
metic expression which is then carefully inspected for common sub-expressions, 
use of the multiply/divide, and so forth. Many Scientific XPL statements are 
compiled into a single,directly executable machine instruction, 


This manual explains how the Scientific KPL Operating System is used to 
enter, save, compile, and execute programs for an ABLE computer. The features 
available in the Scientific XPL language are explained in a separate manual 
called the Scientific XPL Reference Manual. 
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Starting the Systen 


1. Turn or the power to the computer, terminal, and any other equipment 
you will be using. 


2.  cnsert a System Disk in the lett-most drive. Be sure to observe the 
proper orientation when inserting the Gisk; tne label should be up and the 
slot should face forward (away fron you). Also, be sure to use a System Disk 
that matches the corfiguration oF the system you are using. The configura- 
tion information is always recorded on the diskette label. 


3. Insert a User Disk in the right-most drive. 
4. Press the Load button on the front of the computer. 


The computer will respond with a READY on the terminal. The system is now 
ready to accept a commend, or list of commands, instructing the system what 
to do next, 


If the terminal "beeps" when you press Load, either the System Disk has 
Deen corrupted by exposure to a stray magnetic field or you have obtained the 
wrong diskette. You should try a different System Disk to alleviate this 
problen, 


If the terminal does not respond with READY efter loading, perhaps the 
System Disk has been corrupted by incorrect use of DISKWRITE. 


Appendix I lists several precauvions that should always be followed when 
handling diskettes. Diskettes can be damaged by stray magnetic fields, dust, 
or even Tingerprints, so follow tnese precautions carefully. 


Appendix II provides introductory information on Using the Terminal. 
First-time users should consult this section for further information. 


Be sure to remove both the System and User diskette whenever the power to 
the computer is turned on or off. Diskettes can be corrupted by unfavorable 
power transients if this precaution is not followed. 


When entering information into the computer fron the terminal, a 
control=Z or rub-out is used to delete the previously typed character to cor- 
rect typing errors (a control-% is generated by holding the GRTL key down and 
then typing Z). On most CRT terminals, the cursor will backspace, over- 
print the deleted character with a blank, ara tnen backspace the cursor 


again to indicete where the next character will appear. 


To delete an eritixre line of input, a control~X is used. The word DE- 
LETED will appear on the terminal and the new line may then be entered. 


lf a contrel-S character is typed while the conputer is printing on the 
terminal, the computer will halt until any otner character is typed. This is 


Ko 


used tc freeze the display when using a high speed video CRT. 


Description of Monitor Commands 


User commands are typed in from the terminal to direct the operation cf 
the system, Each command may be abbreviated to its first three letters; for 
example, the LIST command may be typed as LIS. Several commands may be typed 
to the computer on one line. To do this, type a slash (/) or period (.) at 
the start of the multiple command line and use a slash or period to separate 
the different commands on the same line. 


When you are typing commands into the computer, always remember that the 
computer will not process a line of input until the carriage retum key is 
pressed, which you must do at the end of each line. On some terminals the 
carriage return is indicated by the word RETURN, while on other terminals it 
is indicated by the two letters CH, 


The carriage return key is usually always located in the upper right 
hand corner of the terminal keyboard. Look to the right of the P key if you 
are having trouble. 


Summary of Commands 


Basic File Management Commands: 


NEW (filename) initiates entry of a new program 

OLD (filename) calls up a previously saved program 

RENAME (filename) changes name of current file 

SAVE (filename} stores a new file on a Uscr Disxette 
REPLACE (filename) stores a revised version of an old program 
UNSAVE (filename) destroys the saved copy of 2 program 


Performance Comnands: 


RUN initiates complete compilation/loading process 
COMPIL# initiates the compilation of an XPL progran 
CATALOG (LEN, ALL) _ prints a list of SAVED programs 


Auxiliary Comnands: 


LENGTH prints cut the number of words in a program 

NAME prints cut the name of the current file 

CRT Girects the system to enter the ORT editing 
node 

NCRT directs the system io return to the normal 


editing mode 
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miting Commands: 


LIST (1n,1n-1n) prints entire program (or selected lines) 

PRINT (1n,ln-1n) prints entire program (or selected lines) on 
the remote printer 

RES EQUENCE renumbers the lines of a program starting with 
100 and incrementing by 10 

SBHQUENCS renumbers the lines of a program starting with 1 

DES EQUENCE removes the line numbers from each line of a 
program 

EXTRACT (1n,1n-1n,1n) extracts selected lines from the current file 

DELETE (1n,ln-in,1n) deletes selected lines from the current file 

LAST prints the number of the last line in the pre- 
gram 

MOVE (1n-1n,ln) moves a block of lines to alter a specified 
line number (also resequences the file) 


APPEND (filename) ,file- 
name} joins the specified file to the end of the 

current file and performs a resequence 

JOIN (filename), (File- 

name) joins the specified file to the end of the cur- 

cent file without changing line-numbers 

LOCATE (string ,ln,ln-ln) locates specified occurrences of a given char- 
acter string 

CHANGE (string1 ,string2, 


In,1n-1n) changes all occurrences of the specified 
string! to read string2 
BULLD directs the system to enter the automatic line 


nunber mode 


Basic File Processing: OLD and NEW 


4 file is a block of information in the computer. A Tile may be a 
source file containing line numbers and XPL program statements, or a compiled 
file containing instructions to the computer. The commands NEW and OLD are 
used to tell the computer that you wish to use a file. NEW says that you wish 
to ereatc a new file, while OLD lets you call up a file that already exists. 


Creating a NEW file 


A. new file is created ty typing the command NEW, followed by the new name 
that you wish to assign to the new file: 


NEW TESTPROG 


SA 


Remember that a carriage return (CR) must be typed at the end of each line 
before that line will be processed by the computer. The specified file name 
may be up to @ letters long. Be careful to not use a space or control char- 
acter in the filename since this would create confusion when using CATALOG, 


The new file is typed in one line at a time, with each line beginning 
with a line number. You need not type the lines in increasing numerical or- 
der; the computer automatically sorts them by number, Be sure to use line 
nunbers less than 30000 since larger line numbers cannot be processed by the 
Editor program. When typing line numbers, remember that zero, oh, one, and 
el are four distinct characters. 


If you notice a mistake on a line that you have already typed in, just 
retype the entire line; the system will automatically retain only the last 
version typed. To delete an entire line, just type the line number and in- 
mediately follow it by a carriage return (CR). 


Observe the following example. Underlined segments indicate those lines 
that must be typed while the other lines are automatically printed by the 
computer, 


NEW TESTPROG 

READY 

100 this is line 100 in file TESTPROG 
110 this is line 110 


105 notice I typed line 105 after line 110 


90_and here is Jine 90! 
{00 


LIS? 

90 and here is Jine 90! 

105 notice I typed line 105 after line 110 
110 this is line 1190 

READY 


In the example above, the first line is 100: notice the second line that 
was typed began with line number 110. It is a good practice to space the line 
numbers by 10 so that new lines may be inserted at a later time. Remember 
that each line ends with a carriage return (CR). 


Line 105 was typed into the computer after line 110, but when the file 
was printed on the terminal in response to the LIST command, the lines were 
printed out in the correct omer. 


In the above example, the last line number typed was line number 100 fol- 
lowed immediately by a carriage return. As mentioned, typing a line number 
followed immediately by a carriage return dcletes the specified line from the 
Tile, 


Once a source file has been typed in, the SAVE command is used to store 
the file on the Giskette. Files are usually saved on the right-most diskette 
(the user disk), 


SAVE 
READY 


Once a file is saved, it may be called up at a later time via the OLN command: 


OLD TEST FROG 
READY 


Suppose that after saving a file, you wish to add a new line, For this change 
to ve preserved with the rest of the file, use the command REPLACE: 


OLD TESTPROG 

READY 

{20 this is new line 120 
LIST 

90 and herve is line 90! 
105 notice I Lyped line 105 after line 110 
110 this is line 110 

120 this is new line 120 
READY 

REPLACE 

READY 


The SAVES command is used only the first time @ file is saved. Any later addi- 
tions or changes to a file already seved (it is then an old file) are pre- 
served with the REPLACE command. 


The REPLACE command is necessary because there is a Gistinction between 
the file you are currently using and changing at your terminal, and the ver- 
sion of that file which remains stored on the diskette; these are always two 
seperate entities. The current file created by tne command NEW or OLD, exists 
only tenporarily as the file you are presently using. If you arc using an 
OLD file, the current file is a temporary copy of the saved file. As you type 
‘nformation into a current file, that file is the only copy of the new informa- 
tion until you type the SAVE or REPLACE command. As soon as you call up an- 
other file or turn off the system, the current file you had been using disap- 
pears; it is no longer in existence, 


A saved file is a file preserved on a diskettc. When you type SAVE or 
REPSACE, you create a saved file which is a copy of your current file as it 
exists at that moment. Once saved, the preserved version of the file remains 
uncnanged on the diskette until you give a comnand to REPLACE it or to UNSAVE 
it. <A current file called via the command OLD is not the saved file itself 
but merely a temporary copy of it; tne saved file is still vreserved and 


unchanged on the diskette. This is why any changes you type into your current 
file do not affect the saved version of ~he file in any way until you type RE- 
PLACE. ‘Then and only then is the stored file replaced by the revised current 
file. 


In sumnary, if you make entries in or changes to any current file ard 
then leave tnat file without SAVING or REPLACING it, there will be no stored 
recerm of those entries. Any previously saved version, however, will still 
be preserved, unchanged, on the diskevte. 


Command UNSAYE 


The connard UNSAVE operates only on the saved version cf a file. Typing 
UNSAVE destroys the saved version of what is then the current file but does 
not affect the current file itself, As long as you do not change the current 
file with a NEW or OLD command, you still have the temporary, current version 
of the file. That current file is not lost until you call another file or 
sum off the systen. 


Sommard 2ENAME 


The RENAME command is used to assign a new name to your current file. 
After pexfomming the RENAME command, the original saved version of the cur- 
rent file will still be unchanged. Tho effect of rename will only be on later 
SAVE or UNSAVE commands; 


OLD TESTPROS 

READY 

RENAME TESTER2 
READY 

SAVE 

READY 

CATALOG 

THSTPROG TESTER2 
READY 


“ne CATALOG Command 


The CATALOG commend (abbreviated CAT) prints out a list of the nanes of 
the user programs that are saved on a diskette. It is often used to deter-~ 
mine how many files are stored on a ciskette, ard to see which diskette a new 
program should be SAVED on, 


Tne command CAT LEN will print oul the length of each file (in 16-bit 
words) as well as the file names: 


CAT 
TESTER TESTHR2 TES'TPROG 

READY 

CAT LEN 

TESTER 567 TESTER2 603 TEST PROG 3756 


READY 


REATIY 

CAT 

NO FILES ARE SAVED, 
REALY 


NEW TESTERQG 
REATtY 


160 THIS IS LINE 100 IN TESTPROG 

410 THIS IS LINE 110 IN TESTPROG 

105 NOTICE LINE 10S WAS TYPE IN AFTER LINE 110 
L.£ST 

100 THIS 16S LINE 100 IN TESTFROG 

10% NOTICE LINE 165 WAS TYPED! IN AFTER LINE 110 
LtO THIS IS LINE 110 IN TESTFROG 

REAIVY 


SAVE 
READY 


Examples of 


CATALOG 
SAVE 
VESTEROG RENAME 


hiadly 
REPLACE 
(Ad LEN UNSAVE 


TESTRROG SS underlined segments indicate 
lines typed by user, 


REALLY 


RE ALY 


SAV 
REATY 


CAT 
TESTEROG TESTFS 
READY 


NEL TESTE2 
BEAUY 


LO THIS £S LINE 10 IN TESTF2 

a) THIS IS LINE & IN TESTFR? 

2 THIS (S LINE & IN TESTES 

LO THIS TS tiIN& 10 ITN TESTP2 

RE ATIY 

10 


RE ATIY 


CAT 


TESTPROG TESTE TESTF2 

REATIY 

CAT LEN 

TESTPROG SS TESTF 1 wo TESTF2 28 
RE ALIY 


OLE TESTEROG 
RE ALY 


LoS T 

190 THIS IS LINE 100 IN TESTFROG 

LOS NOTICE LINE 105 WAS TYRE IN AFTER LINE 110 
410 THIS IS LINE 110 IN TESTPROG 

REATLY 


OLE TESTF2 

REALTY 

LOSt 

“© THIS IS LINE S&S IN TESTF2 
1Q THIS IS LINE 10 IN TESTF2 
READY 


THES IS & NEW LINE IN TESTF2 
ANI! NEW LINE 25 - THESE ARE NOT SAVED YET 


3 THIS IS LINE SG IN TESTF2 

10 THIS IS LINE 410 IN TESTFR 

1S THIS 18 A NEW LINE IN TESTF2 

2S AND NEW LINE 25 - THESE ARE NOT SAVED YET 
RE ALY 

CAT LEN 

TESTPROG SS TESTFI ape TESTF2 2g 
REATIY 


HE EPLACE 
REATIY 


PAL LEN 
TESTFEROG SS TESTPI we TESTF2 66 


REALY 


UNSAVE TESTFROG 


REATIY 


CAT 


TESTE L 


REALLY 


TESTF2 


UNSAVE TESTF2- 


REALY 
CAT 
TESTP4 


REATIY 


UNS TESTE I 


READY 


CAT 


NQ FILES 


RIEATIY 


ARE SAVET. 
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Accessing Programs on Remote Devices 


The Scientific XPL Operating System includes a feature that allows the 
user to access programs that are saved on remote peripheral devices such as 
magnetic tape. This feature may be used in conjunction with tne OLD, SAVE, 
REPLACE, UNSAVYE, and CAT commands. 


A remote device is specified by using a slash (/) followed by a two 
character device identifier. The slash and identifier are always typed 
after the filename. The following remote devices are available in Scientific 
XPL: 


/F¢ System Flexible Diskette - drive 0 (left-most 3 
/F1 System Flexible Diskette - drive 1 (right-mos+ drive 
/RD Zenote Minidiskette - drive 0 
/R1i Ronote Minidiskette - drive 1 


{TP thru /f7 Tape drives g through 7 
/D% thru /D3 = Sartridge disk drives J through 3 


Using sa remote cevice specifier is very straightforwaml, Observe the 
following OLD command: 


READY 


OLD TESTPROG /F¢ 

READY 
When using a remote specifier with OLD, the operating system will look on 
the specified device for the program. A suitable error message will be 
prizlted if there is no program saved by that name on the device, 


The CAT command can be used to find out which programs are saved on a 
remote device: 


READY 


caT = /e 


READY 
Remote specifiers nay be used with other commands as shown below: 


SAVE/RE 

SAVE  FTLE3/2¢ 
UNSAVE TESTPROG/I# 
REPLACE /F1 


Using the Scientific XPL Compiler ~ RUN and COMPILE 


The previous section explained how line numbered source files are typed 
in from the terminal, In general, such line numbered files will be Scientific 
XPL Source Programs where each line of the program will contain an XPL progran 
statement, 


A trivial example of an XPL program is below: 


{00 PRINT ‘HELLO THRE’; 
110 PRINT 'GOODBY'; 
120 EOF 


- Running a Scientific XPL Program 


The simplest way to run a Scientific XPL program is by using the RUN 
command: 


OLD TRIV 

READY 

LIST 

{00 PRINT ‘HELLO’; 
110 PRINT 'GOODBY'; 
120 EOF 

READY 

RUN 


HELLO 
GOODBY 


READY 


When the RUN command is processed, the user's current file is compiled by the 
Scientific XPL Compiler, and the resulting instructions are loaded into the 
computer's memory and executed, In order to use the RUN command, the System 
diskette must be mounted in the left-most disk drive (drive zero) and the 
User diskette must be mounted in the right-most drive (drive one). 


The compilation of a short XPL program tekes approximately 7-15 seconds 
depending on the system contiguration. Oncc a program has been written and 
Will be used in the future without modification, it is possible to store the 
program in compiled form. By doing so, the compilation will not have to be 
performed at each RUN command so the response will be essentially instan- 
taneous, 


To save 4 program in compiled form, the COMPILE and SAVE commands are 
used, 


The COMPTLE commands operates similarly to RUN, except that the machine 
instructions generated by the compiler are not loaded into the computer's 
memory for execution. Instead, with COMPILE, the compiled object code becomes 
your current file after the compilation. Since compiled files are machine 
instructions instead of letters, compiled files may not be listed on your 
terminal, 


An example of the COMPILE commard is: 


OLD TRIV 

READY 

COMPILE 

MEMORY MAP: 
ENVIRONMENT STARTS ATs: 000000 
OBJECT CODE STARTS AT: 000156 
OBJECT CODE ENDS AT: 000175 
VARTABLE AREA STARTS: 000175 
VARIABLE AREA ENDS AT: 000275 

MEMORY REQUIRED FOR PROGRAM EXECUTION: 189 WORDS. 

CURRENT FILE IS NOW CALLED TRIV, 

READY 


In response to the COMPILE command, the system translates your program into 
executable machine instructions. At the enc of compilation, a memory map is 
printed out on the terminal. The memory map allows you to determine how much 
memory is required to run your program, Note that the numbers in the memory 
map are printed in octal. The total memory required for execution is printed 
in decimal, however, for convenience. 


If the compilation is successful, as in the above example, the current 
file name will cnange - in this case from *TRI¥' to ‘TRIV.' - so that you 
cannot REPLACE the compiled file on tcp of the original source file. File- 
nanes of less thar eight characters in length will have the character ‘'.' 
(period) added to the end of the file name, File names that are exactly eight 
characters in length (such as FILENAME) will have the last character of the 
file name changed to a period {namely ‘FILENAM.'). 


Once a progran has been compiled, the compiled version may be saved on 
the diskette using the normal SAVE commard. 


Compiled files consist of numbers that represent machine instructions 
ana therefore nay not be modified by using line numbers or the edit commands. 
it is imperative that the original source file for every compiled program is 
seved on a back-up diskette, so that modifications to the program can be per- 
formed at a later time. 


Note that the COMPILE comnand in no way affects the saved version of 
your current file. After compilation, your current file will be the compiled 
object code, whereas the saved version will te the originel source file that 
wes compiled. 
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In general, when a program has been developed and no further modifica- 
tions are anticipated, the program should be compiled, and SAVED in compiled 
form. To RUN a compiled file, the standard RUN command is used. Since the 
program will be in compiled form, program execution will begin immediately 
after the RUN command is typed. 


OLD TRIV. 

READY 

LIST 

COMPILED PROGRAMS MAY NOT BE EDITED OR LISTED 
READY 


soceeees (output from program TRIV) 


A. special feature may be used with RUN to direct program output to either 
the terminal or the remote printer. This is used to create a hard copy of 
output that would otherwise appear on the CRT screen. The command sequence 
RUN, PRINTER is used instead of the normal RUN to activate this feature. 


READY 

OLD TESTPROG 

READY 

RUN 

ae (output from TESTPROG) 


READY 


RUN, PRINTER (output will be directed to remote printer) 
READY 
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RE ALY 

car 

NO FILES ARE SAVER, 
REALLY 


NikW TRIV 
REALTY 


FRINT “HELLO? ¢ 
20 FRINY “GOODURYE? 
40 EOF 


MELLO 
GOOBBYE 


RE ATIY 


SAY 


Examples of RUN 


and COMPILE 


READY 


COMP ILE 
MEMORY MAFE 
ENVIRGNMENT STARTS AT? 600000 
ORJECT COLE STARTS AT39000303 
ORJECT COE ENTS AT 000323 
RAM AREA STARTS ATIO20000 
KAM AREA ENDS ATIO20100 
MEMORY REQUIRED FOR THIS PROGRAM? O82546 WORIS,. 
COMP TLATION SUCCESSFUL ~ CURRENT FILE £9 NOW CALLED "TRIV,* 


REAY 


SAVE 
REALTY 


cal 
TRIV TREV,. 

READY 

RUN 

HELLO 

CHOQUEYE 

REALTY 

PAT LEN 1? 


FRIV ee TRIV, eit 


Notice that the Hiitor commands operate only on the current file, and do 
eo not affect the SAVED ccpy. Alterations to the current file that are made 
by an Editor command are written out to the diskette only in response to the 
REPLACE command. 


Edit Commands: LIST 


The LIST command is used to generate a printout of the contents of a 
program that is stored on a diskette. The simple command ‘LIST’ will print 
the entire contents of the current file on the terminal: 


READY 

OLD TESTPROG 

READY 

LIST 

100 /* TEST PROGRAM #1 */ 
110 DECLARE I FIXED; 

120 INPUT I; PRINT I* I; 
130 BOF 

READY 


Optionally, the LIST command may be used to list only a section, or 
several sections of the filc. Each section is identified by the starting 
and ending line number of that section. For example, the command 


LIST 100-200 


would only list line 100 through lines 200 on the terminal. If there were no 
lines in the specified group, then there is no printout on the terminal. 


Several sections nay be specified in one LIST command; 
LIST 100-200, 300 ,400-500 


The above comnand would print line 100 through 200, line 300 (if there was a 
line 300), and lines 400-500, 


4 special case of the LIST command is the word LIST followed by exactly 
one line number: 


LIST 200 
If LIST is followed by just ONE line number, all the lines from the 
specitied line through to the end cf the program are listed. However, IF the 


lire mmber is followed by a comma, then only the one line is printed; 


LIST 200, 
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Auxiliery Commands: LENGTH and NAME 


The LENGTH command is used to find out the length, in 16-bit words, of 
the current file. A source file consists of line numbers, plus the individual 
characters that make up the progran statements on each line of the file. Each 
line number requires one 16-bit word of storage while each 16-bit word can 
store two letters. 

Tne NAME command is used to determine what the eurrent file name is. It 
is most convenient in the middle of a long editing session when you can't find 
the piece of paper that lists the last NEW, RENAME, or OLD command that you 
typed! 


The Editor 


The Editor refers to a section of the Monitor program that performs some 
very useful textual processing based upon commands typed in from the terminal. 
While files can ve altered by retyping an incorrect line, it is sometimes 
necessary to change line numbers or delete a whole section of a program. 

The edit commards perform many useful functions: 


1. Listing a section or sections of a complete file (LIST, PRINT) 


2. Changing the line-numbers in a program (RESEQUENCE, SBQUENCE, DE- 
SEQUENCE) 


3. Deleting a section or sections of a program, (DELETE) 

4, Extracting a section or sections of 4 program. (EXTRACT) 

5. Find the last line in a program (LAST) 

6, Moving a group of lines to a different section of the program. (MOVE) 
?. Combining programs that are saved on a diskette (JOIN, APPEND) 

8, Locating lines that contain a specified string (LOCATE) 


9. Changing several occurrences oF a character string to a new string 
(CHANGE), 


10, Autcmatic line number generation (BUTLD) 
1i, Ferform video editing (G27, NCRT). 
Editor commands are typed in from the terminal at any time. Each command 


Operates on the current file, or the body of textual material that would be 
rinted on the termina? in response to the LIST command. 


Lg 


The word #ND may be uscd instead of a line number with all the editor 
commards to specify the end of the program: 
LIST 500~END 


READY 


The following page contains examples of the LIST command, 


REATLY 


OLD TESTFROG 
RE ALIY 


10 LINE 10 IN 
20 LINE 20 IN 
JO LINE 30 IN 
40 LINE 40 IN 
SO LINE SO FN 
60 LINE 60 EN 
70 LINE 70 IN 
gO LENE 80 IN 
VO LINE 90 TN 
REATIY 


Lis 50-70 

VO LENE OQ IN 
60 LINE 60 IN 
7O LINE 70 IN 
RE ALY 


TESTPROG 
TESTPROG 
TESTPROG 
FESTFROG 
TESTPROG 
TESTPROG 
TESTFRGG 
TESTFEROG 
TESTPROG 


TESTFROG 
TESTEROG 
TES TFEROG 


LES 40750-60790 


3O LINE 30 IN 
SO LINE SO IN 
60 LINE 40 EN 
PO LINE 90 IN 
READY 


LAIST Soo 
REATIY 


Lis 20730-40 
20 LINE 20 IN 
30 LENE 30 IN 
40 LINE 40 IN 
RE ATIY 


LIS so? 
RE ATIY 


LIS BO 

80 LINE 80 IN 
PO LINE 90 IN 
REATEY 


LIS 20 

2O LINE 20 IN 
30 LINE 30 IN 
40 LINE 40 IN 
JO LINE SO IN 
60 LINE 60 IN 
70 LINE 70 IN 
80 LINE 80 IN 
PO LINE 90 IN 
IE ATHY 


TESTFROG 
TESTFROG 
TESTFEROG 
TESTPROG 


TESTFROG 
TESTEROG 
TESTFEROG 


TESTFROG 
TESTPROGG 


TESTPROG 
TESTEROG 
TESTPROG 
TESTEROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTPROG 


Fdit Commands; PRIKT 


The PRINT command operates similarly to LIST except that the output will 
appear on the remote hard copy printer. The PRINT command is most often used 
while editing from a Video terminal enc @ print-out is desired. 


PRINT 
PRINT 200-300 
PRINT 300, 500, 600-EIn 


Line-Numbers: RESRQUENCE 


Three Editor commands are available for changing the line-numbers that 
are associated with each line of a2 program. This is often done to prepare a 
program for a "clean" printout with the LIST command. Other times it is re- 
quired during the entry of a new program and one wisnes to insert a new line 
in between two consecutively numbered lines. 


The most often used command is RESHQUENCE. Resequence changes all the 
line numters in the program. After the rescquence is completed, the first 
line number will be {00, and each line number will be ten greeter than the 
number on the preceding line. Examples of KESRQUENCE will be found on the 
following page. 


The SEQUENCS command operates sinilarly to RESEQUENCE in thet every line 
numcer in the file is changed. After a SHQUENCE command, the first line 
number Hill be 1, and each line nunber will be one greater than the number on 
the preceding line, 


DESEQUENCE removes tne line rumber from each line in a file. It is most 
often used for generating a printout of material, such as a letter, that does 
not contain line numbers. After a DES"QUENCE, be sure to SHQUENCE or RE- 
SEQUENCE tne program before editing or typing new lines. 


REALTY 


QL 
REALY 


SO LINE 
REALIY 


RESEQUEN 


REATIY 


LoS 7 
100 LINE 
120 LINE 
120 LINE 
1340 LINE 
140 
LEO 
146 


LINE: 
LINE 
170 LINE 
196 LINE 
REALY 


LINE ¢ 


10 
20 


: 30 
= 40 
a0 


40 
70 


- 80 


70 


CE 


SEQUENCE 


REATLIY 


LES 

1 oLUNE J 
« LINE 2 
3 LINE 3 
4 LINE 4 
o LINE & 
& LINE 6 


? LINE 9 
RE ALY 


DE SEQUEN 


REALLY 


LS T 


CE. 


TES TERROG 


TESTPROG 
TESTPROG 
TESTFROG 
TESTEROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTPROG 


TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TE STFROG 


TESTFROG 
TESTFFROG 


TESTPRUG 
TESTPROG 
TESTFROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTFROG 


LINE 
LINE 
LINE 
LINE 
LINE 
LONE 
LUNE. 
LINE 
LONE: 
AE ALY 


10 
20) 
40 
40 
50) 
40 
20 
80 
30 


TESTFROG 
TESTPROG 
TESTFEROG 
TESTFROG 
TESTPROG 
TES TR ROG 
TESTFEROG 
TESTEROG 
TESTFROG 
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Editor Commands DELE?E and EXTRACT 


The commands DELETE and EXTRACT are used to delete or extract individual 
lines, or groups cf lines, from the current file. 


The format for the DELETE comnand is: 

DELETE 100,200-300,/400 
DELETSH is followed by a list of numbers that indicate the lines of the progran 
that are to be affected, Individual lines may be deleted by specifying the 
line number, or entire blocks cf lines may be deleted by specifying the start- 
ing and ending line number separated by a hyphen (200-300 for example). 

The EXTHACT command onerates similarly to DELETE. The specified lines, 
or groups of lines, are extracted from the current file. All other lines will 
be lost. 


For both the EXTRACT and DELETE commands, the line numbers must be speci- 
ficd in increasing order. For example, the command 


EXTRACT 200,100, 500-800,400 
will not. perform correctly, and instead should be typed: 
EXTRACT 100,200,400, 500-800, 


Exemples of EXTRACT and DELETE are on the following page. 


2h 


REAIY 


OL. Yt 


TESTFPROG 


REALTY 


» 10 
» 2a 
30 
- 40 


; 60 
= 70 
: F&O 
90 LINE 90 
REALLY 


DELETE 
REALY 


Liar 
LINE 
L. INE: 
LUNE 
i. ENE 
LINE 
?O LINE 20 
REALY 


10 
20 
30 
40 


= OO | 


vO tf 


TES TFEROG 
TESTEROG 
TESTEROG 
TESTFEROG 
TESTFROG 
TES TEROG 
TESTFROG 
TESTRPROG 
TESTFROG 


HO-8O 


TESTFROG 
TESTPROG 
TESTPROG 
TES TEROG 
TES THROM 
TESTFROUG 


DELETE 2040590 


REAHY 


LIST 

LO LINE 10 
3O LINE 30 
9O LINE SO 


HELE TE: 30 
REATHY 


LEST 
10 LINE io 
30 LINE SO 
REATIY 


NELETE £0-5 


REALIY 
ENGTH 
ON000. 

REATHY 


Lot 


CAN NOT PROCESS AN EMPTY FILE! ¢ 


STOF! 
REAL 


IN TESTFROG 
IN TESTFROG 
IN TESTFROG 


IN TESTEROG 


IN TESTEROG 


6) 


sun 


REALLY 


GIT 
REALLY 
LIS 


——, 


10 LINE 
LINE 
LINE 
LINE 
LINE 


LINE 


LINE 
90 LINE 
REALTY 


EXTRACT 
REALTY 


80 LINE 
READY 


EXTRACT 
REALLY 


LIST 

20 LINE 
40 LINE 
wO LINE 
60 LINE 
80 LINE 
REATY 


EXTRACT 
REALTY 


LIST 

920 LINE 
80 LINE 
REALY 


LINE 7 


TESTFROG 


IN TESTFPROG 
IN TESTFROG 
IN TESTPROG 
IN TESTFROG 
IN TESTFROG 
IN TESTFROG 
IN TESTFROG 
IN TESTPROG 
IN TESTFROG 


20~-BO 


20 IN TESTFROG 
30 IN TESTFROG 
40 IN TESTFROG 
SO IN TESTFROG 
60 IN TESTFROG 
70 IN TESTFPROG 
80 IN TESTFPROG 


oO »r40-60 780 


20 IN TESTPRGG 
40 IN TESTFROG 
SO IN TESTFROG 
40 IN TESTFROG 
80 IN TESTFROG 


JO» BO 


90 IN TESTFROG 
BO IN FESTFROG 


100 


EXTRACT 


READY 


LENGTH 
00000, 
REALY 


I £ST 
CAN NOT 


STOP! 
REALY 


FROCESS AN EMFTY FILE?! 


Editor Commands: LAST 


A. particularly useful Dditor command is the LAST command, While process- 
ing the LAST command, the system reads through the current file and finds the 
last line of the program. The line number of the last line is then printed on 
the terminal. 


By using SEQUENCE and LAST, you can find out the number of source lines 
=n a program. Alternatively, after performing a SEQUENCE or RESHQUENCE, by 
using the LAS’ command anc the LIST command, the final section of the program 
car be examined, 


i 
“I 


REALY 


OLD TESTFROG 


REALLY 


10 JINE 
20 LIWE 
30 LINE 
40 LINE 
00 LINE 
60 LINE 
79 LINE 
80 LINE 
90 LINE 
READY 


LAST 


10 IN 
20 IN 
30 IN 
40 IN 
270 IN 
60 IN 
7O IN 
80 IN 
90 IN 


TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 


LAST LINE NUMBER IS 90 


RIS ALY 


LIST 70 


70 LINE 
80 LINE 
9O LINE 
READY 


70 IN 
80 IN 
70 IN 


TESTFROG 
TESTFROG 
TESTFROG 
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Editor Commands: MOVE 


The MOVE command is used to move one line, or a block of lines, toa 
different section of the program. A RESEQUENCH command is automatically per- 
formed after the MOVE, 


MOVE 50-100,200 
MOVE 90,180 


MOVE takes the line specified by the first line number, or group of lines 
specified by the starting and ending line number separated by a hyphen, and 
moves it to a position in the file after the specified line of the file. MOVE 
must be followed by two numbers separated by a comma (MOVE 100,50) in the case 
of a one line move, or three numbers (MOV 200-300,800) in the case of a move- 
ment of a group of lines. 


It is possible to move a line or group of lines to any position of the 
file. For example, lines 200 through 300 may be moved to after line 800 by 
the command 


MOVE 200-300 ,800 


Alternatively, lines 200 through 300 may te moved to an oarlier position in 
the file (for example, after line 100) by the command 


MOVE 200-300,100 


Examples cf MOVE will be found on the following page. 


REA 


OLi 


TESTFRO 


REA 


70 


ny 


ly 


LINE 90 


G 


20-401 80 


1480 
KEA 


, 
LINE 10 
LINE 30 
LINE 406 
LINE 70 
LINE 80 
LINE 20 
LINE 39 
LINE 40 
LINE 90 
Ly 


MOVE 1007180 


REA 


Lis 
1090 
110 
120 
130 
140 
150 
149 
170 
180 
REA 


ny 


1 
LINE SO 
LINE 460 
LINE 70 
LINE 80 
LINE 20 
LINE 30 
LINE 40 
LINE 0 
LINE 10 

ly 


TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 


TESTFPROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTF ROG 
TESTFRGG 


TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TES TFROG 
TESTFROG 


MOVE £40-150+140 


REA 


ETS 
100 
£10 
120 
130 
140 
L5O0 
140 
170 
180 
REA 


ny 


+ 
LINE SO 
LINE 460 
LINE 70 
LINE 80 
LINE 40 
LENE 20 
LINE 30 
JLINE 90 
LINE 16 

Ly 


TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTF ROG 
TESTFROG 
TESTFROQG 
TESTEROG 
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Sditor Commands: JOIN and AFPERD 


The Editor commands JOIN and APPEND are used to combine two files that 
are saved on a diskette, JOIN and APPEND operate similarly, except that a HE- 
SEQUENCE is performed automatically after an APPEND. 


READY 
APPEND TESTPROG 
READY 


APPEND combines the specified file to the end of the current file. The re- 


sulting file then becomes the current file. A RESRQUENCE is automatically 
performed after an APPEND, 


Examples of APFEND and JOIN will be found on the following page, 


Severel different files may be combined at the same time by using a comma 
to separate several filenames: 


READY 
APPEND TESTPROG, FILEA, ®ILEB 
READY 


Lo 
> 


Fee AVY 


TESTFROG 
REATIY 


OL. fl 


LINE 


REALTY 


JOIN TESTEROG 


READY 


L. 0 NEE 


READY 


OLE 


TESTEROG 
REALTY 


LIST 


10 
eae) 
26) 
40 
0 
£0 
7O 
350) 
20 


LINE 
LINE 
LINE: 
LONE 
L. INE 
LINE 
LUNE 
LT NE: 
LINE. 


READY 


TESTFROG 
TESTF ROG 
TESTFROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTFROG 
TESTFROG 


TESTFROG 
TESTPROG 
TESTFROG 
TESTPROG 
TESTFROG 
TESTFROG 
TESTEROG 
TESTPROG 
TESTEROG 
TESTEROG 
TESTFPROG 
TESTFRDG 
TESTRROG 
TES TRROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTFROG 


TESTPROG 
TES TEROQG 
TESTFROG 
TES TRROG 
FTE STFEROG 
TESTFROG 
TES TPRROG 
TESTFPROG 
TESTE ROG 


m 


PRENII 
REATY 


t00 LINE 
LINE 
120 LINE 
130 LINE 
140 LINE 
LS0 LINE 
160 LINE 
170 LINE 
180 LINE 
190 LINE 
200 LINE 
210 LINE 
220 LINE 
230 LINE 
240 LINE 
250 LINE 
260 LINE 
270 LINE 
REALTY 


TESTFEROG 


TESTPROG 
TESTFROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTFROG 
TESTPROG 
TESTPROG 
TESTPROG 
TESTFROG 
TESTFROG 
TESTPRUG 
TESTFROG 
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Beitor Comnands: LOCATE and CHANCE 


Another section of the EDITOR locates, dcletes, inserts, and replaces se- 
quences of characters in a file. It is normally used to edit linc-numbered 
files but has limited use with files that have been DESHQUENCED, The two 
relevant commands arc LOCATE and CHANGE. 


As you will see in the examples that follow, there are several command 
formats available for LOCATE and CHANGE, These formats vary in how the line 
number is specified. The acceptable formats for specifying line numbers are: 


1. No line number - If no line number is specified in the command then 
the first occurrence of the sequence of characters is acted on according to 
the command. 


2. Single line number - If exactly one line number is specified in the 
LOCATE or CHANGE command, then all occurrences of the sequence of characters 
in the specified Jine will be acted upon. 


3. A block of lines - If a block of lines is specified (for example, 
10-30), then all occurrences of the seauence of characters in that block are 
acted on accerding to the command. 


4, ALL - if the word ALL is used instead of a line number, then all oc- 
currences of the sequence of characters in the file will be acted upon accord- 
ing to the command. 


LOCATE 


Examples; 


LOCATE IF 
LOCATE iF ,20 

LOCATE IF, 20-440 

LOCATE iF, 20-2ND 

LOCATE =F ,ALL 

LOCATE IF, 20~30,60-80, 200 


LOCATE prints the line(s} containing at least one occurrence of the 
specified sequence of characters. The first two formets listed above will 


never print more than one line. 


Notice, as in the last example above, several groups of lines may be 
specified. 


The following page lists some examples of LOUATE. 


REALY 


OLD TESTPROG 
REATIY 


10 BECLARE (NUM+sI)> FLOATING? 
20 [TG NUM=0 TO S BY 2% 

30 FRINTs 

40 [TO I=NUM TO NUM+Is 

SQ FRINT ¢ “yTy’S “yEXP CT) os 
40 ENIty 

70 ENT 

BO FRUNT? 

90 EBFSs 

REATIY 


LOCATE l10,+ALL 

20 10 NUM=0 TO S RY 23 
40 ft0 I=NUM TO NUM+F13 
REATY 


LOCATE TiO 
20 TO NUM=0 TO S HY 23 
REALLY 


LOCATE YO» 40-END 
40 T10 T=NUM TO NUM+1% 
REANY 


LOCATE D0, 80+ENTI 
STRING NOT FOUNT 


STOF ! 
REALY 


LOCATE TvyiQ-S0%20 

LO TECLARE ¢NUMsT) FPLOATINGs 
20 QO NUM=0 TO S HY 2% 

JO PRINT: 

40 [0 T=NUM TO NUM+15 

JO FRINT ” “sIy’S “vEXPCL) 95 
READY 


LOCATE Mrl0-50290 

10 TECLARE (NUM»I> FLOATING? 
20 [110 NUM=O TO S RY 23 

40 T0 f=NUM TO NUMt+1s 

READY 


/¥TECLARE FLOATING VARIARLES*/ 
/EPRINT TWO COLUMNS*/ 

7*PRINT CARRIAGE RETURN/LINE FEELK/ 
“7*FOQR EACH COLUMN ACROSS PAGEX/ 
/KPRINT TrEXP CI)» WITH SFACESK/ 


/KFINAL CARRIAGE RET/LINE FEEDX/ 


/KERENT TWO COLUMNS #/ 
“*FOR EACH COLUMN ACROSS PAGEK/ 


*KPRINT TWO COLUMNS 


“FOR EACH COLUMN ACROSS FAGEX/ 


ZHTIECLARE FLOATING VARIABRLESX*/ 
/*PRINT TWO COLUMNSX/ 

7KPRINT CARRIAGE RETURN/LINE FEEDX/ 
/*FOR EACH COLUMN ACROSS PAGEXK/ 
/KPRINT ITxsEXFCI)s WITH SPACESK/ 


/*RECLARE FLOATING VARTABLESK/ 
/KPRINT TWO COLUMNS*/ 
“*FOR EACH COLUMN ACKOSS FAGEX/ 


CHANGE 


Examples; 


CHANGE WILE,WHILE 

CHANGE WILE,WHILE,10 

CHANGE WILE ,WHILZ, 20-40 

CHANGE WILE ,WHILE, 5O-END 

CHANGE WILE ,WHELE , ALL 

CHANGE WILE, WHILE, 20-50 , 200-300, 500 


CHANGE substitutes the second string, or sequence of characters, for the 
first string in the indicate line(s). In the above examples, the string WILE 
was replaced by the string WHILE in the specified lines. 


Notice, as in the last example above, several groups of lines may be 
specified in a single CHANGE command. 


The following page list some CHANGE examples. 


A slash (/} is used to process text strings that contain special 
punctuation characters such as a comma (,) or a slash cae If the editor 
encounters a slash in the character string, the slash is ignored and the 
next character after the slash is used as part of the character string even if 
it is a delimiter such as a slash or comma. For example, in order to change 
the string 4/B to A¥3, the command: 


CHANGE A//B,A*B 
would be used. Similarly, commas may be processed with CHANGE by preceding 
the comma with a slash. For example, to change the string 'A,B‘ to 'A-B' 
the command: 

CHANGE 'A/,B','A-B' 


would be used. 


REALLY 


OLA TESTFPROG 


REALY 

LIST 

10 DECLARE ¢(NUM:sI) FLOATING? /EDECLARE FLOATING VARTABLESK/ 

20 [0 NUM=0 TO S BY 23 “¥P RINT FWO COLUMNS*K/ 

30 FRINTS /KPRINT CARRIAGE RETURN/LINE FEEDIK/ 
40 TO I=NUM TO NUM+1¢s /*FOR EACH COLUMN ACROSS PAGEK/ 


SO PRINT ‘ “yTr’t *sEXPCI) 8 7¥PRINT TsEXF¢I)s WITH SFACESK/ 
60 END 


70 END; 

BO PRINTS “/*KFINAL CARRIAGE RET/LINE FEEIRK/ 

90 EOFS 

REATIY 

CHANGE [IECLARE»THIS.WAS.TIECLARE 

REALY 

List 

10 THIS.WAS.AECLARE (NUM+I) FLOATING? /*¥TDECLARE FLOATING VARIABLESk/ 
2O TM NUM=0 TO S BY 23 /KFRINF TWO COLUMNSK/ 

30 FRINTs S*KPREINT CARRIAGE RETURN/LINE FEEDK/ 
40 [10 I=NUM TO NUM4+13 /*KFOR EACH COLUMN ACROSS FAGEXK/ 


SO PRINT “ “oT ’s “yEXPCI)  § /HPRINT TxEXP CI)» WITH SFACESK/ 
60 END» 


70 ENT? 

80 FRINT3 “*¥FINAL CARRIAGE RET/LINE FEED 

90 EOF» 

REATLY 

CHANGE YOrRLEEFPsALL 

REALY 

LIS 

10 THIS.WAS, DECLARE (NUMsI) FLOATING? /ETIECLARE FIGATING VARIABLES*/ 
20 BLEEF NUM=0 TO & BY 23 /KPRINT TWO COLUMNSK/ 

JO FRINT? /¥PRINT CARRIAGE RETURN/LINE FEED*/ 
40 BLEEF I=NUM TO NUM+i> 7*FOR EACH COLUMN ACROSS FAGEX/ 


JO FRINT ¢ “eI ’%3 “yp EXP CI) ys /H¥PRING Es EXP CL)» WITH SFACESK/ 
60 ENT 

7O ENI+ 

BO FRINTS /KFENAL CARRIAGE RET/LINE FEED 
90 EOFs : 

READY 


HANGE FRINTs THIS.WAS FRINTs50~-80 


LIs 

‘10 THIS, WAS. DECLARE (NUM,I) FLOATING /ENECLARE FLOATING YVARIABLESK/ 
20 BLEEP NUM=0 TO S HY 2¢¥ “Z¥KPRINT TWO COLUMNS */ 

30 FRINTs /KPRINT CARRIAGE RETURN/LINE FEED 

40 KBLEEF IT=NUM TO NUM+13 /¥FOR EACH COLUMN ACROSS PAGEK/ 


30 THIS.WAS- PRINT ¢ “oTy%s 7p EXF CIOs > /KTHIGSWAS.FRINT ITeEXF(I)» WITH 
60 ENIIs 

7O ENTts 37 

80 THIS.WAS,FRINTs /KFINAL CARRIAGE KET/LINE FEEIK/ 
20 EOF + 

REATIY 


ORT Fditing 


The Seientific XPL Operating System includes a special CRT command that is 
very useful wher editing a program from a video terminal. To entcr the CRT 
mode, just type the CRT command: 


READY 


CRT 
READY 


The CRT command is normally typed once at the beginning of a programming 
session. The system will stay in CRT mode until the NCRT command is typed or 
the power is turned off, 


When the computer is in CRT mode, the LIST and LOCATE commands operate 
in a special manner. In response to LIST, the computer will clear the CRT 
sereen, fill the screen with one page of output, and then halt. At this point 
if a line-feed is typed, one more line will be added to the screen; 
if an 5 is typed, the computer will stop the LIST and print READY , or 
if any ovher character is typed, the next page of output will appear on 


whe screen, 


When using LOCATE while in CRT mode, the screen is not cleared at the 
start of LOCATE, however, the computer will stop after one page of output if 
enough lines are printed. A line-feed, 5S, or any other character may then be 
typed to continue or abort the LOCATE. 


Edit Commands; BUILD 

The BUILD command is used to enter textual information into the computer 
in an auto-line numbered mode. To enter BUILD mode, just type BUILD: 

READY 


BUILD 
ENTERING BUTLD MODE NOW 


100 


After typing 3U:LD tne computer enters a special mode where the line 
numbers are automatically assigned and necd rot be typed in by the user, A 
line number of 100 is used when 3BUILDing @ new filey whereas a line number 
that is 10 greater than the last line number in a file is used when adding to 
a program. 
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ee ee 


When you are through with BUILD, type a single carriage return. The 
computer Will respond with READY and the file may now be edited, using the 
normal line-number techniques. . 
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APPENDIX I 


Notes on the Handling of Diskettes 


Notes on the Eandling of Diskettes 


The flexible @iskettes provided by New England Digital Corporation are 
of the highest quality available. To achieve the maximum possible data reli- 
ability and diskette integrity, it is imperative that the diskettes be handled 
carefully, stored in a protected dust-frec environment, and inscrted into the 
proper disk drive at the proper tine. 


The following rules should always be observed when handling flexible 
diskettes: 


1. A protective cover is provided with each diskette. Always store 
the diskette inside this protective cover when it is not inserted into the 
diskette drive. Never place an unprotected diskctte on a table top, counter, 
terminal, or other place or dust particles picked up by the diskette surface 
might render the diskette useless. 


2. Never bend cr otherwise physically abuse a flexible diskette. When 
handling a diskette, hold it by the edges gently to avoid damaging the re- 
cording surface, 


3. When inserting a diskette into a disk drive, be careful to insert the 
diskette straight into the slot and never at an angle. The diskette should 
slide almost effortlessly inte the drive - any other condition indicates im 
proper insertion, 


-4, The diskettes are vemperature sensitive and should always be kept at 
a temperature between 50° Fo and 125° *. Best results will be obtained when 
the diskette is always kept at room temperature. 


5» Never touch the exposed magnetic surface visible in the slot on one 
side or the diskette. Dust or moisture on this surface may destroy the dis- 
kette, 


§, Since the flexible diskette is a magnetic storage media, never expose 
the diskette to stray magnetic fields. Common devices such as telephones, 
microphones, dictation machines, and nunerous other instruments contain small 
internal magnets. If a diskette is unreadable after exposure to a magnetic 
field, it must be erased and reformatted before it can be used, 


7. Eacn diskette has a white paper label indicating the tyne of diskette 
(usually “minidiskette no.” and "SA10L” appear on this label). While it is 
possible to write on this label for diskctte identification, always use ea felt 
tip pen when labeling a diskette. The high pressures associated with a ball- 
point pen may reach through the diskette case and damage the recording sur- 
face underneath. 


=f the above rules are Zollowed, each disxette should give you 100% data 
reliability. A diskette thet is physically damaged by dirt, liquid, or 
physical abuse shculd te replaced immediately before such contamination is 


Lad, 


+ a kenn cram tae“ 


transferred to the internal mechanism of the diskette drive. A diskette that 
has been magnetically erased by exposure to stray fields, may be reformatted 
and returned to service. 


Making Back-up Copies 


To guard against the loss of important data or program material when a 
@iskette is damaged ty accidental misuse, conscientious computer users develov 
the habit cf regwarly maxing backup copies of such material. The procedure 
for making a backup copy of a program is exccedingly simple, as follows: 

i. Turn on your system and load the Scientific XPL Operating System in 
the normal fashion. Insert the Jser diskette that contains the program you 
Wisk to duplicate in the right-most drive at this time. 


2. Type the OLD command to call up the desired program from the User 
Diskette: 


OLD_PROG2 
READY 


3. At this point, you may remove the User Diskette from the right-nost 
drive (drive one). Be sure to not remove the System Diskette from the left~ 
most drive (drive zero}. (Be exceedingly careful here - inserting the wrong 
erate into the upper drive may destroy the programs stored on that dis- 
kette! 


4, Now insert a second User Diskette (one that you reserve for backup 
copies) into the right-most drive (drive one). 


5. At this point, you may type the SAVE or REPLACE command to write a 
copy of the program ouz to your backup diskette: 


SAVE 
READY 
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Using the Terminal 


Using the Terminal 
A Brie? Description of the Terminal 


Most terminals look like typewriters. They have a modified typewriter 
keyboard and print on paper. Other terminals have a keyboard and a TV screen; 
lines are “printed” on the screen instead of on paper. This type of terminal 
is often called a CRT (for cathode ray tube) or scope. 


When you sit down at a terminal that is unfamiliar to you, take some 
time to get to know it. First, you must find the ON/OFF switch. It may be on 
the front, top, side, back; under the terminal, or even cn the wall. Also 
find the RETURN key, the BREAK key (which may be marked BREAK or BRK or ATTN 
or INT), and the CONTROL key (which may be marked CONTROL, CTRL or CTL). You 
will be using each of these keys often. 


Typing on the Terminal 


Typing accuracy is importent in all interactions with the computer, You 
are essentially carrying on a conversation with the computer; when you t:rpe 
something, a special supervisory program interprets it and responds in some 
way. Since the computer understands only cervain commands and cannot guess 
what you mean to say, you must type with care. Ccrtain features of typing on 
the computer terminals which may differ from the customary use of a typewriter 
are discussed below. 


Unlike some typewriters, the terminal has scparate keys for zero and the 
letter oh and for one and the letter el. In general, the computer notices 
spaces, so type spaces only where they are needed. If you follow the spacing 
in oux examples, you'll have no trouble. Also, the computer does not process 
what you type until you press RETURN, so remember to do so at the end of each 
line you type. 


Since almost everyone makes typing mistakes, the system is dcsigned to 
allow such misvakes to be corrected easily. To delete the preceding charac~ 
ter, hold down the CONTROL key and press the % key; to dclete more than one 
preceding character, repeat this process once for each character to be deleted, 
To delete the entire current line of type, simultaneously press the CONTROL 
and X keys (the terminal will print DELETED). ‘Control characters are not 
printed on the terminal and, when CONTROL Z is used, do not cause the current 
position on the line to change. In any case, do not try to backspaca and 
cverstrike to 7ix errors. The computer will simply accept each tackspace as 
& new character an@ will not erase the old ones, 


Some terminals type only in upper case; others opcrate like any upper- 
case and lowercase typewriter. For any system commards that you type, the 


computer essentially makes no distinction between cases; if you type in lower 
case, it will translate to upper case. When you begin creating your own files, 
information will be stored just as you type it. 


Interrupting the Computer 


Whenever you want to interrupt the computer during a program run or 
listing, you may do so by pressing the NULL, ATTN, INTERRUPT, or BREAK key; 
use whichever key your terminal has. While the terminal is typing you can 
also stop the typing ard the program by pressing the S key. 
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